Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Transforming Points and Vectors

Q3RationalPoint4D_To4DTransformArray

You can use the Q3RationalPoint4D_To4DTransformArray function to apply a transform to each point in an array of four-dimensional points.

TQ3Status Q3RationalPoint4D_To4DTransformArray (
const TQ3RationalPoint4D *inVertex, 
const TQ3Matrix4x4 *matrix, 
TQ3RationalPoint4D *outVertex, 
long numVertices, 
unsigned long inStructSize, 
unsigned long outStructSize);

inVertex

A pointer to an array of four-dimensional points. This is the source array.

matrix

A 4-by-4 matrix.

outVertex

A pointer to an array of four-dimensional points. This is the destination array.

numVertices

The number of vertices.

inStructSize

The size of an element in the source array. Effectively, this is the distance, in bytes, between successive points in the source array.

outStructSize

The size of an element in the destination array. Effectively, this is the distance, in bytes, between successive points in the destination array.

DESCRIPTION

The Q3RationalPoint4D_To4DTransformArray function returns, in the outVertex parameter, an array of four-dimensional points, each of which is the result of multiplying a point in the inVertex array by the matrix transform matrix. The outVertex array contains the same number of points (that is, vertices) as the inVertex array, as specified by the numVertices parameter. The inStructSize and outStructSize parameters specify the sizes of an element in the inVertex and outVertex arrays, respectively.